home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Amiga Game-Power
/
Amiga Game-Power.iso
/
anwendungen
/
gw print
/
manual
< prev
next >
Wrap
Text File
|
1994-05-20
|
21KB
|
449 lines
Welcome to TextED!!
Congratulations! You have just purchased the most
powerfull text editor made for the Amiga! TextED is
a text editor that can be used by the casual user
and by the advanced programmer.
MKSoft TextED is based on the powerfull Unix text
editor known as EMACS so most of the keyboard
commands will be the same.
This file contains a quick manual describing
the features of MKSoft TextED. Please expand this
window to full size and read on....
-----------------------------------------------------------------------------
-----------------------------------------------------------------------------
MKSoft TextED -- Copyright (c) 1986 by Michael Sinz -- MKSoft
-----------------------------------------------------------------------------
-----------------------------------------------------------------------------
Changes to TextED -- Amiga Version 2.8
1. The word-wrap function is debugged and installed in the menus.
This function only word-wraps on input. TextED is not designed
as a word processor but rather a text processor, mainly for
program source code. This feature was added for typing of large
comments.
2. Some of the routines have been optimized. Many are now much smaller
or work faster. (Sometimes both)
3. Now will open to FULL SCREEN on an INTERLACE workbench!
4. Better menu handling. You can't flood it anymore.
5. Longer maximum line length.
6. Longer MACRO buffer.
7. Completely recompiled with AZTEC C for smaller/faster code
8. Does not bring up the CREDITS screen at the start of the program.
I have changed this so that TextED is faster to use from the CLI.
You now do not have to use the mouse to CONTINUE from that point.
It has been moved to a menu item.
9. All new FILE REQUESTER. This one gives you a list of files in
alphabetical order with directories at the top. Complete with
PROP gadget. Simple to use. Click on directory and it loads
the new directory. Click on a file and it puts that file name
in the FILE gadget. Click on OK and it uses the name in the file
gadget. You can also enter the path and file names directly into
the gadgets.
10. Fixed bug with FRIENDLY TOOL icons. When starting TEXTED by selecting
a TextED Project icon or shift-collecting a text file and the TextED
program, the file and the program do not have to be in the same
directory or device. This one was found using the AZTEC debugger
that comes with the compiler. Highly recommended!
11. All features work with FAST RAM installed. No more problems with
CHIP memory graphics.
12. Faster loading of files. Sorry, but the clearing of a large buffer
still takes some time since it also deallocates the memory for that
buffer at the same time. (Allocated on a LINE by LINE basis.)
13. Does not bomb out it the workbench font is set differently. It will
always reopen TOPAZ.8 as the TextED Font. Only the window title
and top of menu bar will be in the workbench font.
Changes to TextED -- Amiga Version 2.9
14. Sets its priority to 1 so that background compiling does not slow down
the interactive aspects of TextED. Since most of the time TextED is
waiting for user input, this setting does not slow down the compile
by any large amount.
15. Increased the display speed by optimizing one of the routines. I hope
it is fully debugged. (Seems like it is, but there might be a few
small anoiances. (Interlace mode, most likely)
Changes to TextED -- Amiga Version 2.9a
1. Recompiled under Manx 3.4b for scatter loading... Slightly larger
file, but it now loads into a highly fragmented memory space. Also
the run-time image is smaller and runs faster...
2. Fixed the exit code so that it returns the task to initial priority
level. This one was easy to fix, but I had a hard time trying to
find out why my task sometimes went to priority 1. Finally found
out that TextED was leaving it there when it finished...
-----------------------------------------------------------------------------
-----------------------------------------------------------------------------
MKSoft TextED -- Copyright (c) 1986 by Michael Sinz -- MKSoft
-----------------------------------------------------------------------------
-----------------------------------------------------------------------------
1. Introduction
TextED is an advanced text editor that was designed for the Amiga
computer system. It makes use of dynamic memory allocation so that it will
only take as much memory as it needs for the files that it is editing. This
means that you will have more memory available for other programs which
might be running at the same time in your Amiga's multi-tasking OS. And,
as your file gets larger, TextED will not tell you "BUFFER FULL" unless you
have no more memory in the whole computer. (0 bytes free at the top of the
WorkBench display.) So, if you have a 8 megabyte Amiga system, you would
be able to edit a file that large!
TextED knows if you are running from the WorkBench or the CLI and will
act accordingly. That means that when you use TextED from the WorkBench,
it will save your files and attach an ICON to them. But, for the advanced
user who uses TextED from the CLI, it will not make an ICON for the files
it saves. This reduces the clutter on the disk for the advanced user while
still giving the WorkBench user the ICONs he wishes.
For the programmer, TextED features auto-indent and true tabs. This
reduces the time it takes to keyboard a program with indentation since
TextED will automatically indent the next line the same as the line
before. Also, the tabs are stored as tabs and act as tabs which makes the
files smaller and, for you assembly programmers, the changing of the
program much faster. While TextED is not a wordprocessor, it does have a
word-wrap option. This document was created with TextED.
TextED has full menu support for all but the most basic functions such
as cursor movement. TextED also has a full help system that is available
at the touch of the HELP key. And, for you mouse lovers, the cursor can be
positioned with the mouse.
TextED, like the Unix EMACS editor, lets you edit multiple files at the
same time. You can even cut and paste between files. There is no real
limit on the number of files that can be edited at the same time other than
memory limits, however, the number of "windows" or files visible at a time
is limited by the size of this window. Also, you can have two different
views of the same file without having to load the file twice! This makes
debugging much easier since you can look back in the code without loosing
your place.
-----------------------------------------------------------------------------
2. The display...
The TextED window is like any other window that you will use on the
Amiga. You can size it, drag it, or shuffle it. It will respond to your
every command. It is in this window that TextED lives. The bottom line of
the display is used to give you messages and ask for special input such as
a search string or file name. The rest of the display is used by TextED to
display its windows. These windows are not like the other Amiga windows in
that they are part of the TextED window. These windows are "views" into
the file or files you are editing. The windows are separated by a status
line which gives you the following information:
« » buffername --» filename «-----------------------------------------------
^ ^ ^
| | |
| | This is the name of the file being edited.
| |
| This is the name of the TextED buffer the file is in.
|
This is the status of the buffer. If blank, the buffer is unchanged from
what is in the file on disk. If it has a C in it, the buffer has some
changes and should be saved if you do not want to loose your work.
When you split the screen, you get another view into the buffer you
were working on. You can then either work with that buffer or select a new
buffer and edit a different file in there. Try splitting the screen by
using the menu or by pressing Shift-F2 (the 2 is for make 2 views). You
can the make a view get larger (F1) or smaller (F2) or split it again or
make the current view the only one (Shift-F1). Thus, with a full sized
TextED window, you could have up to 11 different views on the screen at once!
The CLOSE WINDOW gadget in the TextED window does not only quit TextED
but also saves the current buffer if it has changed. (It is the same as
pressing F10 or ctrl-Z) This is to protect you from any loss of text. (see
the section on file i/o for more information on SAVE & EXIT)
To move the cursor in the TextED window, you can use the mouse by
pointing to the position you wish to move to or you can use the keyboard
arrow keys. Using the arrow keys without the Shift key moves the cursor
one character in the direction of the arrow. However, with the shift key
held down while the arrow key is pressed, the cursor will move to the
beginning or end of the line (Shift-Left and Shift-Right) or to the
previous or next screen page (Shift-Up and Shift-Down). Using CTRL and
Shift makes the cursor move to the previous or next word (CTRL-Shift-Left
and CTRL-Shift-Right) or to the beginning or end of the file (CTRL-Shift-Up
and CTRL-Shift-Down) This gives you complete control of the cursor.
+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
NOTE: Due to a bug in the Amiga Console Device, these are the only functions
of the cursor keys. When the bug is fixed, the keys will have the
following functions: (Note: Version 1.2 Fixes this bug...)
Key | Plain | Shift | CTRL | CTRL-Shift
--------|------------|------------|-----------|------------
Left | Move one | Beginning | Previous | Previous
Arrow | character | of line | word | window
--------|------------|------------|-----------|------------
Right | Move one | End of | Next | Next
Arrow | character | line | word | window
--------|------------|------------|-----------|------------
Up | Move one | Previous | Beginning | Scroll
Arrow | line up | page | of file | Up
--------|------------|------------|-----------|------------
Down | Move one | Next | End of | Scroll
Arrow | line down | page | file | Down
--------|------------|------------|-----------|------------
+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
-----------------------------------------------------------------------------
3. Files and buffers...
TextED uses a method of storing files in memory while they are being
edited that facilitates the editing of unlimited number of files. To keep
track of all of this, the files are stored in buffers that are many times
the same name as the file. (Unless you asked differently) While you are
editing inside one buffer, the other buffer remains unchanged. TextED even
remembers where your cursor was when you left last.
Each buffer also stores the name of the file that it is holding. This
information is displayed in the status line while you are working with that
buffer.
To edit a file, you just have to enter into TextED (run it or double
click it from the WorkBench) and then ask to read a file into a buffer.
There are two different versions of this command. The first version reads
the file into a new buffer. That is, it creates a buffer different from
the ones that you have already and then loads the file into it. (This
command is F8 or ^X^V)
The second version reads the file into the current buffer. This
command destroys what was in that buffer and replaces it with the file.
Use this command to prevent having all of the files you are editing at one
sitting from staying in memory. (This is Shift-F8 or ^V^R)
When you want to save the buffer, you again have two choices. The
first saves the buffer into the file which is shown in the status line.
The second lets you enter the name of the file into which the buffer is to
be saved. (These are F9 and Shift-F9 respectively)
When you wish to exit TextED, you can either Exit without saving the
buffer or Exit after saving the buffer. Only the current buffer is saved.
If there are any buffers that have been modified and not saved, TextED will
ask you if you are sure you would like to quit. If you answer NO, you will
be in TextED as if you never left. You can then save the buffers you want
saved and then exit. (The SAVE & EXIT command is F10 or the CLOSE WINDOW
gadget.)
-----------------------------------------------------------------------------
4. Cut and Paste -- EMACS style.
TextED lets you cut and paste between buffers so that you can get data
from one file into another. However, TextED uses the EMACS method of Cut
and Paste. Here is a quick lesson on how to use these functions.
In TextED, the section of the buffer you are going to Cut or Copy is
called the REGION. The region is defined as the section of the buffer
between the MARK and the DOT (the DOT is another name for the CURSOR) The
MARK is a position in the buffer that you set. To set the MARK, move the
cursor to the position and press F6 (or use the menu). Then move the
cursor to the other end of the section of text. To cut the text, press
Shift-F7 (or, again, use the menu). To paste this text, press Shift-F6.
You can move to a different buffer and paste the text again. You can paste
the text as many times as you want as long as you do not clear the paste
buffer. (The paste command is known as YANK in the EMACS world.) The only
other command that uses the paste buffer is ctrl-K (kill to end of line) or
multiple deletes (Using the repeat command operator ctrl-U)
The MARK is also useful for remembering a position while you go off and
look at another area of the file. You can then return to that position by
using the SWAP DOT and MARK command. (F7) This command will place the
cursor where the MARK was and place the MARK where the cursor was. This
lets you flop back and forth between two different areas of the file. (A
useful function for programmers.)
5. Searching and Search & Replace
TextED lets you search through the file for any type of string. You
can search foreward (F3) or reverse from the current cursor position. If
you would like to search for the third time the search string is found, use
the repeat command operator. (See the next section.)
The search and replace function (Shift-F3) is somewhat like the search
command. However, it can only work forewards. It will search for the
search string and replace it with the replacement string. It will only do
this once, but if you would like to do the whole file, just enter a large
number with the repeat command operator. (See next section.)
NOTE: Both search and search & replace ignore case.
-----------------------------------------------------------------------------
6. Repeating a command many times...
Now this one is useful! This is a pre-command sequence that will force
the next command to be repeated as many times as asked for. This command
can be used to get to a specific line or to search & replace over the
entire file.
To use this command, type ctrl-U (or use the menu) and then the number
of times you wish to repeat the command. Use only numbers and do not try
to BACKSPACE since this will BACKSPACE that many times. If you make a
mistake, press ctrl-G. (Abort from the menu) After you finished typing
the number, type the command you wish to repeat (or use the menu). DO NOT
PRESS RETURN AFTER TYPING THE NUMBER. That would only repeat the return
key. For example, if you wish to get to line 233 of your file, go to the
top of the file and type the following:
<ctrl-U> <2> <3> <2> <down arrow>
The reason you entered only 232 is that you are on line one when you
started so you only have 232 lines to go. This is great for finding the
lines with a compiler error.
To search & replace all (or most) of the buffer, you should type:
<ctrl-U> <9> <9> <9> <9> <9> <9> <Shift-F3>
and the search and replacement strings. That should get most (if not all)
of them. (If you have more that 999,999 of the string, type a larger
number. You can type up to 1,999,999,999 (without the comas) since the
program uses a 32-bit integer. However, anything over that amount could
cause problems.)
-----------------------------------------------------------------------------
7. The MACRO function...
TextED has a simple macro function. (Future versions of TextED will
have an advanced MACRO language) The MACRO function lets you record your
keystrokes and then replay them when you want. (It also works with the
menus) The MACRO may contain any command but the MACRO commands
themselves. Thus you can make a MACRO that reformats your text. (That one
is neat!) To make a macro, you must tell TextED to start recording your
keystrokes. This is done with Shift-F4. When you have finished making you
macro, you tell TextED by pressing Shift-F5. Then, you can execute your
macro by pressing F4. (Again, you can use the MENUs for all of this.) The
macro may contain anything, including text or editing functions or even
cut & paste commands.
-----------------------------------------------------------------------------
8. Command Summary
Keys Description Amiga Keyboard
------------ ----------- --------------
ctrl-@ Set MARK <F6>
ctrl-A Go to beginning of line <Shift-Left>
ctrl-B Left <Left>
ctrl-C Start a new CLI task
ctrl-D Delete next character <DEL>
ctrl-E Go to end of line <Shift-Right>
ctrl-F Right <Right>
ctrl-G Abort command (See note)
ctrl-H Backspace <BACKSPACE>
ctrl-I Tab <TAB>
ctrl-J New line without auto-indent <ENTER>
ctrl-K Delete to end of line
ctrl-L Repaint the whole screen
ctrl-M New line with auto-indent <RETURN>
ctrl-N DOWN -- Next line <Down>
ctrl-O Open line at cursor
ctrl-P UP -- Previous line <Up>
ctrl-Q Quote next keystroke
ctrl-R Reverse search
ctrl-S Foreward search. <F3>
ctrl-T Twiddle characters
ctrl-U set repeat command
ctrl-V Go to next page. <Shift-Down>
ctrl-W Cut region. <Shift-F7>
ctrl-X This is the leadin for other commands
ctrl-Y Paste (Yank) region back <Shift-F6>
ctrl-Z Save and Exit <F10>
<HELP> Help on these commands <HELP>
-----------------------------------------------------------------------------
These commands are all started with typing ctrl-X and then the command listed
(Amiga Keyboard shortcuts do not need the ctrl-X)
Keys Description Amiga Keyboard
------------ ----------- --------------
ctrl-B List the buffers
ctrl-C Exit without save <Shift-F10>
ctrl-F Rename the file in the buffer
ctrl-L Set region to lower case
ctrl-N Scroll up
ctrl-O Delete blanks
ctrl-P Scroll down
ctrl-R Load into current buffer <Shift-F8>
ctrl-S Save buffer to file <F9>
ctrl-U Set region to upper case
ctrl-V Load into new buffer <F8>
ctrl-W Save to new file <Shift-F9>
ctrl-X Swap DOT and MARK <F7>
ctrl-Z Shrink window <F2>
! Execute a CLI command
= Show cursor position and status. <F5>
( Start MACRO <Shift-F4>
) End MACRO <Shift-F5>
1 Set current window to full size. <Shift-F1>
2 Split current window <Shift-F2>
B Select a buffer to view
E Execute the MACRO <F4>
F Set Wrap Column
K Kill a buffer
N Next window
P Previous window
Z Enlarge current window <F1>
ctr-X <HELP> Displays this list of commands
-----------------------------------------------------------------------------
These commands are all started with typing <ESC> and then the command listed
(Amiga Keyboard shortcuts do not need the <ESC>)
Keys Description Amiga Keyboard
------------ ----------- --------------
ctrl-H Delete previous word <Shift-BACKSPACE>
! Set cursor position as Top of Window
. Set MARK <F6>
> Go to end of file <Ctrl-Shift-Down>
< Go to beginning of file. <Ctrl-Shift-Up>
B Move backward one word <Ctrl-Shift-Left>
C Capitalize word
D Delete next word <Shift-DEL>
F Move foreward one word <Ctrl-Shift-Right>
L Set word to lower case
S Search & Replace <Shift-F3>
U Set word to UPPER CASE
V Move backward one page <Shift-Up>
W Copy region
-----------------------------------------------------------------------------
NOTE: The ABORT command (ctrl-G) is used to abort any command that requires
keyboard input such as the SEARCH command or SELECT BUFFER command.
-----------------------------------------------------------------------------